home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / macfile1.zip / MACFILE.DOC < prev    next >
Text File  |  1993-01-13  |  22KB  |  489 lines
  1.  
  2.  
  3.                       ╔═══════════════════════════╗
  4.                       ║ A MÄC's Place BBS Release ║
  5.                       ╚═══════════════════════════╝
  6.  
  7.  
  8.  
  9.                   MACFILE: Roll Your Own File Listing Door
  10.                   ~~~~~~~  ~~~~ ~~~~ ~~~ ~~~~ ~~~~~~~ ~~~~
  11.  
  12.                                Version  1.0
  13.  
  14.  
  15.                     Copyright (c) 1993 John W. McNamara
  16.                              All rights Reserved
  17.     
  18.  
  19.                          Written By: John McNamara      
  20.                         
  21.                               MÄC's Place BBS    
  22.                                   Dunn, NC           
  23.  
  24.                           (919) 891-1111 [16.8 DS] 
  25.         
  26.                           Release Date: 15 Jan 1993
  27.  
  28. MACFILES - Version 1.0                                           Page - 1
  29.  
  30. ┌────────────────────────────────┐
  31. │ Files included in this Zip:    │
  32. └────────────────────────────────┘
  33.  
  34.     MACFILE.EXE       - Main File MACFILE Executable File, Version 1.0
  35.     MACFILE.CNF       - MACFILE Sample Configuration File
  36.     MACFILE           - MACFILE Sample PCBoard Door File
  37.     MACFILE.DOC       - Information on File MACFILEs Door
  38.     MACFILE.TXT       - MACFILE sample description file
  39.  
  40. MACFILE - Version 1.0                                           Page - 2
  41. ╔══════════════╗
  42. ║ Introduction ║
  43. ╚══════════════╝
  44.  
  45.   Welcome to File  MACFILE, Version 1.0 "Roll Your Own File Listings DOOR".
  46.   Basically there was a need (as explained to me by my users) to have a
  47.   "simple" door in which a user could go into and select file listings
  48.   that interested them for later download.  I know there are other door
  49.   programs that do this and even more extensively than MACFILE however
  50.   spending all your time in a door going through menus and having to
  51.   remember what dir is what takes time, and time is what this DOOR was
  52.   designed to save.  If you wanted to spend alot of time in a door
  53.   selecting directory listings then you might as well grab the ALLFILES
  54.   list that most BBS's provide.  Anyway, I hope you enjoy the MACFILE
  55.   door as much as my users have.  It quickly became the 2nd most used
  56.   door on my bulletin board next to MACSEC (MAC's on-line security update
  57.   door allowing users to upgrade themselves based on sysop parameters).
  58.  
  59.  
  60.  
  61. MACFILE - Version 1.0                                           Page - 3
  62. ╔═══════════════════════════════╗
  63. ║ File MACFILE Door Operation:  ║
  64. ╚═══════════════════════════════╝
  65.  
  66.   The operation of the File MACFILE Door is straight forward. The programme  
  67.   presents the welcome screen and then displays the main menu. 
  68.  
  69.                        File MACFILE/DESTINATION Door
  70. For a 2 file system:
  71.  
  72. [S] Select / Deselect file listings
  73. [H] Help
  74. [C] Create Download File listing and quit to BBS
  75. [Q] Quit to BBS
  76. [G] Log off BBS
  77. ┌────────┐
  78. │ Select │
  79. └────────┘
  80. By choosing this option, you will be presented with a full file
  81. listing of the BBS.  Simply choose the number of the directories you
  82. want and the "-" will be replaced with an "+"  All files marked with
  83. a "+" will be added to the .ZIP file created by the BBS.  By choosing
  84. a "0" (zero) if there are more than 60 listings it will display the
  85. next screen of directories.  After the second screen and after the
  86. first screen the "0" will take you back to the main menu.  
  87. ┌──────┐
  88. │ Help │
  89. └──────┘
  90. Brings up a full screen help.  The help is slightly differnent depending
  91. on how many directories are listed.
  92. ┌────────┐
  93. │ Create │
  94. └────────┘
  95. By choosing this option a file is created using a list formed by
  96. the choices selected.  If no directories where flagged then it
  97. doesn't create anything and exits to the BBS.  If there are flagged
  98. files a .ZIP file is created for user download.  The next version
  99. will auto-flag the file for download in the main BBS as soon as I
  100. figure out how to accomplish this task.
  101. The file created by the door is in the form of YRLSTx.ZIP where "x"
  102. is the node number of the BBS.  YRLST0.ZIP will be the file if the
  103. BBS is not running a multi-node system.
  104. ┌──────┐
  105. │ QUIT │
  106. └──────┘
  107. The user can return to PCBoard after they have finished using the 
  108. MACFILE Door. No file will be created even if some are selected.
  109.  
  110. ┌─────────┐
  111. │ GOODBYE │
  112. └─────────┘
  113.   Finally, the user can exit the BBS from the DOOR.
  114.  
  115. MACFILE Version 1.0                                             Page - 4
  116.  
  117. ╔══════════════╗
  118. ║ INSTALLATION ║
  119. ╚══════════════╝
  120.  
  121. Requirements:
  122.  
  123. - Dos 2.1 or higher
  124. - PKZIP MUST be in DOS path or local directory where MACFILE is installed
  125. - Enough memory for PKZIP to work (see PKZIP manual)
  126. - PCBoard 14.x (any version)
  127.  
  128. 1. Configure PCBoard for MACFILE door:
  129.      Using PCBoard's PCBsetup program, add the door to your list of doors.
  130.      Fields:
  131.         Filename        -        SYSOPs Choice   (must match startup file)
  132.         Password        -        SYSOPs Choice
  133.         Sec             -        SYSOPs Choice
  134.         Login           -        SYSOPs Choice (Not recommended)
  135.         User Sys        -        Yes
  136.         Door Sys        -        No
  137.         Shell           -        No
  138.         Path to Files   -        Not Needed
  139.  
  140. 2.  Make directory for MACFILE door
  141.      - Make a directory to hold the MACFILE door files.
  142.      - i.e.  mkdir \doors\MACFILE
  143.  
  144. 3.  Create the start up file i.e. MACFILE
  145.      - a sample is listed below
  146. --------------  cut here ----------------
  147.       @echo off
  148.       c:
  149.       cd \doors\macfile
  150.       macfile macfile.cnf
  151.       cd \pcb
  152.       board
  153. --------------  cut here ----------------
  154.  
  155. 4.  Copy files to appropriate places
  156.      - copy macfile door files to the MACFILE door directory.
  157.      - copy the startup file into the default PCBoard directory i.e. \pcb
  158.  
  159. 5.  Create the configuration file  i.e. MACFILE.CNF
  160.   #######################################################################
  161.   Sample macfile.cnf file
  162.   Line 1:  Location of file containing descriptions
  163.   Line 2:  Root name of Directory listings 
  164.            (i.e. It would be "DIR" for DIR1, DIR2, DIR3, etc)
  165.   Line 3:  Location to put the created ZIP FILE. (normally a "free" dir)
  166.            Filename is YRLSTx.ZIP where "x" is node number. (so there
  167.            is no conflict on a network)
  168.   Line 4:  Location where the ACTUAL DIRxx text files are located files
  169.            are located.
  170.   --------------  cut here ----------------
  171.   d:\doors\macfile\descript.txt
  172.   dir
  173.   d:\pcb\free
  174.   d:\pcb\gen
  175.   --------------  cut here ----------------
  176.  
  177. MACFILE Version 1.0                                             Page - 5
  178.  
  179. 6.  Create the description file.
  180.   ##########################################################################
  181.   Sample descript.txt File
  182.   Line 1:  Number of descriptions following Line 1: (min 1, max 120)
  183.   Line 2 - number in Line 1: descriptions of each directory. 
  184.            (max 21 chars in length) (it really doesn't matter if you put 50
  185.            only 21 wil be printed in the file listing) All chars allowed
  186.            spaces, slashes, numbers etc........
  187.            This description will also handle PCBoards @variables@
  188.   --------------  cut here ----------------
  189.   52
  190.   Archivers
  191.   Communications
  192.   BBS
  193.   PCboard
  194.   Virus/Security
  195.   Professional
  196.   Paradox
  197.   R:base
  198.   Database(s)
  199.   Benchmarks
  200.   Clipper
  201.   Education
  202.   Finance/Business
  203.   Health/Medical
  204.   FREEDownloads
  205.   TextFiles
  206.   Spreadsheet
  207.   Disk Utils
  208.   File/DirUitls
  209.   Shells/Menus
  210.   Periodical/src
  211.   MailReaders
  212.   Words/Editors
  213.   Batch Utils
  214.   Keyboard Utils
  215.   Memory Utils
  216.   Screen Utils
  217.   Misc Utils
  218.   Reserved
  219.   DOSSystem
  220.   MSWindows
  221.   OS/2
  222.   Multitasking
  223.   Lan/Networks
  224.   Science/Engineer
  225.   DTP/Clippart
  226.   Legal
  227.   CAD
  228.   Geoworks
  229.   GraphicsApp/Viewer
  230.   Games
  231.   Fonts
  232.   Reserved
  233.   Language: C/DOS
  234.   Language: C/UNIX/GNU
  235.   Language: C++
  236.   Language: ASM
  237.   Language: Pascal
  238.   Language: Basic
  239.   Language: Other
  240.   Programmers Tools
  241.   RECENT UPLOADS
  242.   --------------  cut here ----------------
  243.  
  244. MACFILE Version 1.0                                             Page - 6
  245.  
  246.  ╔═════════════════════════════╗
  247.  ║  A MÄC's Place BBS Release  ║
  248.  ╚═════════════════════════════╝
  249.  
  250. History of the File MACFILE Door Changes  [in reverse order]
  251. ═════════════════════════════════════════
  252.  
  253.     MACFILE 1.0:  15 Jan 1993
  254.  
  255.          o Initial Public Release
  256.  
  257.     MACFILE 0.8ß: 5 Jan 1993
  258.  
  259.          o  Initial BETA release to a small group of BBS's.
  260.             I want to thank these folks  for their help.
  261.             Normally MÄC's Place has a group of 19 BETA sites
  262.             we use regularly, but this one went real clean.
  263.  
  264.             Channel One BBS            919-354-3137
  265.               SySops - Brian Miller/ Tess Heder
  266.  
  267.             FreeWare Hall Of Fame BBS  804-293-4710
  268.               SySop - Rey Barry
  269.  
  270.             Poor Boy's BBS             615-239-3073
  271.               SySop - Ron Herring
  272.  ╔═══════════════╗
  273.  ║  Future Plans ║
  274.  ╚═══════════════╝
  275.  
  276.  - To make the file created auto-flagged in the main BBS
  277.  - To handle unlimited number of directories.
  278.  - Limit lists to take only "new since last" files
  279.  - Create a simpler interface.
  280.  - Release the C++ source code.
  281.  - Win the MegaBucks lottery in Mass. and retire.
  282.  
  283.  
  284. MACFILE Version 1.0                                             Page - 7
  285.  
  286.  These  files  are  distributed  under  the  FreeWare concept - freely 
  287.  available  to PCBoard  SysOps. Please  Do Not   distribute  modified  
  288.  versions without permission of the author.
  289.  
  290.  Do Not remove this notice or any other copyright notice.
  291.  
  292.                          ╔══════════════════╗
  293.                          ║══════════════════║
  294.                          ║    DISCLAIMER    ║
  295.                          ║══════════════════║
  296.                          ╚══════════════════╝
  297.  
  298.  
  299.    THIS PRODUCT IS LICENSED  "AS IS" WITHOUT ANY WARRANTY OF MERCHANTABILITY
  300.    OR FITNESS  FOR  A  PARTICULAR  PURPOSE,  PERFORMANCE,  OR OTHERWISE. ALL
  301.    WARRANTIES ARE EXPRESSLY DISCLAIMED.  BY  USING  THE  FILE  MACFILE  DOOR 
  302.    PROGRAM    YOU AGREE THAT JOHN MCNAMARA WILL NOT BE  LIABLE TO YOU OR ANY 
  303.    THIRD PARTY FOR ANY USE OF (OR INABILITY TO USE)  OR  PERFORMANCE OF THIS 
  304.    PROGRAMME, OR FOR ANY DAMAGES WHATSOEVER WHETHER BASED ON CONTRACT,  TORT 
  305.    OR OTHERWISE. EVEN IF WE ARE NOTIFIED OF SUCH POSSIBILITY IN ADVANCE.
  306.  
  307.    You may not reverse-engineer, disassemble, modify,  decompile or  create
  308.    derivative works of this programme.  Piracy has been investigated by the
  309.    FBI and prosecuted under federal statutes.   Applicable law provides for
  310.    damages  and recovery of attorney's fees.   Distribution  of  any  MAC's 
  311.    Place BBS  Release program's  in  any  medium  without  its accompanying 
  312.    documentation is  an  unauthorized  modification.  That  is  a  theft of 
  313.    intellectual property.  
  314.  
  315.    ----------------
  316.      PCBoard  (C) is a registered trademark of Clark Development Company.
  317.      PKZip (C) is a register trademark of Phil Katz and PKWare, Inc.
  318.  
  319.     MACFILE Version 1.0                                             Page - 8
  320.                                  LICENSE
  321.                                  =======
  322.  The  MACFILE  PCBoard  Door  programme  can be  freely distributed  so
  323.  long  as  it  is  not  modified  or  sold  for  profit.  If you find that the
  324.  programme is  valuable, you  can send  a donation  for what  you think  it is
  325.  worth.  A donnation of $5 is suggested.
  326.  
  327.  Please Send your contributions to:
  328.  
  329.  
  330.     MAC's Place BBS
  331.     ATTN:John McNamara
  332.     P.O. Box 911
  333.     Dunn, NC 28335
  334.  
  335.  If you have any questions, bugs, or suggestions, please contact:
  336.  
  337.                                    
  338.      John McNamara - SysOp         
  339.      Mäc's Place BBS               
  340.      (919) 891-1111 16.8K Dual Std
  341.  
  342.    The latest version is always available for downloading.
  343.  
  344. ╔══════════════════════════╗
  345. ║ File MACFILE Background: ║
  346. ╚══════════════════════════╝
  347.   John McNamara wrote all the code for File MACFILE in approximately 5 Hours.
  348.  
  349.   The File MACFILE door programme is written in C++  and was compiled with
  350.   Borland C++ 3.1  The MACFILE C LIBrary    The MACFILE source  code LIBrary
  351.   was modified  and recompiled  with our  specific improvements.  The C++
  352.   language  was choosen for  writing several of  the  MÄC's Place BBS PCBoard
  353.   utilities   such as   File MACFILE Door  because  of  its  speed and
  354.   flexibility.  The C++  source is available upon request and for small fee.  
  355.  
  356.      Author:
  357.                                      
  358.      John McNamara - SysOp           
  359.      MÄC's Place BBS                 
  360.      (919) 891-1111 [16.8 DS]
  361.  
  362.     MACFILE Version 1.0                                             Page - 9
  363. ╔═══════════════════════════════════╗
  364. ║ Other FreeWare By MAC's Place BBS ║
  365. ╚═══════════════════════════════════╝
  366. ZAP1.ZIP         1185  01-01-89  Interactive process killer for UNIX
  367.                                | SYSTEMS  "C" source
  368. XCHANGE.ZIP     35061  01-01-89  Find out where your calling in Mass
  369. YATSCOR1.ZIP    11000  01-01-89  Bulletin generator for EX-10 Yahtzee Door
  370. SOLSCOR1.ZIP    11000  01-01-89  Bulletin generator for EX-10 Solitairre Door
  371. AREA21.ZIP      21761  01-01-89  Areacode Identifier for the U.S.
  372. UPCASE.ZIP      15963  01-01-89  Convert Turbo Pascal key words to Upper Case
  373. MACGREP1.ZIP    11348  01-01-89  UNIX-Like Grep for DOS
  374. MACKILL2.ZIP    19856  05-30-90  Search & Destroy ! A "whereis" type Program
  375.                                | that prompts you to delete the file.  Scans
  376.                                | entire default drive, wildcards etc.  Brought
  377.                                | to you by MÄC's Place BBS. FREE From Door 2
  378. MACOPY1.ZIP     14966  03-31-92  MACOPY V1.0 Search all drives and 
  379.                                | directories for a file(s) and copy
  380.                                | it over to a different location.
  381.                                | Great for BBS's or large networks,
  382.                                | save all those "whereis" commands
  383.                                | prior to copy a file somehwere
  384. MACWHERE.ZIP    15050  03-31-92  MacWhere V1.0 extreamly fast Whereis
  385.                                | program, Search all drives and dirs.
  386.                                | Wildcards, pause mode, very fast.
  387.                                | Don't just search current drive, search
  388.                                | them ALL in the same amount of time
  389. MACWHICH.ZIP     8282  01-15-92  UNIX like "WHICH" for DOS. V1.0
  390.                                | Now find out what your about to run
  391.                                | BEFORE you run it.  Helpful on networks
  392.                                | to avoid running others creations.
  393.                                | Brought to you buy MÄC's Place
  394.                                | BBS and free from door 2
  395. MACWIN1.ZIP      3712  12-27-91  MAC WIN 1.0 for MS Windows 3.0 Increase
  396.                                | windows performance 5-10 times, by making
  397.                                | your windows screen writes fly.  Transparent
  398.                                | uses no memory, not a TSR.  It makes you
  399.                                | think you have a new computer.  Must have.
  400.                                | Works with all the favorites, Corel Draw, all
  401.                                | the games, WinWord, etc. FREE from MAIN BOARD
  402.                                | A MÄC's Place BBS release.
  403. KILLBAK4.ZIP     8196  01-15-92  Announcing!! Kill Bak V4.0 file Killer
  404.                                | Searches All drives/directories for files
  405.                                | ending in .BAK by default.  Now it takes
  406.                                | Arguments so it will hunt down ANY file
  407.                                | you want, wildcards accepted. VERY fast
  408.                                | Works across Novell, 3-Comm, Lantasic &
  409.                                | many other networks including PC-NFS so
  410.                                | now you can even search UNIX drives.
  411.                                | Brought to you buy MÄC's Place
  412.                                | BBS and free from door 2
  413. HOTDOG31.ZIP    60024  01-01-89  PCB 11,12,14 User Base Management utility
  414. HOWLONG.ZIP     21760  05-31-90  Time the execution of any program.. Great
  415.                                | for bench marking your programs. Yet another
  416.                                | MÄC's Place utility. Free from door 2
  417. HSTUFF41.ZIP    63303  08-30-90  HOTSTUFF V4.1 Popular file & Statistics
  418.                                | report for PCBoard.  A must for PCBoard
  419.                                | SYSOPS. Brought to you by MÄC's Place
  420.                                | Removed Co-Processor specific switch,
  421.                                | Sorry about that folks
  422. HCOMP40.ZIP     12266  08-30-90  HOTSTUFF Companion V4.0 Strips unwanted lines
  423.                                | from Files.  A MUST for HOTSTUFF or ProWho
  424.                                | Now strips up to 3 patterns at a time
  425.                                | Brought to you by MÄC's Place
  426. EDITPTH3.ZIP    11734  05-30-90  Edit your DOS PATH without rebooting your
  427.                                | computer.  Version 3.0 Brought to you by
  428.                                | MÄC's Place. Its freeware
  429. DATEKILL.ZIP     8000  01-01-89  Deletes PCBOARD caller log/any file when it
  430.                                | gets to be a certain day of the month
  431. CHKTXT.ZIP      33550  01-01-89  Determines Readability of Text files
  432. BOPDIR2.ZIP     18970  01-15-92  he ultimate recursive directory deleter,
  433.                                | Fast, delete's a directory, any sub-dirs
  434.                                | and files found in the dirs.  Brought to
  435.                                | from MAIN BOARD.  Used to be KILLDIR
  436. BUDMAN30.ZIP    12151  08-30-90  BUDMAN V3.0 DOWNLOAD.TXT file splitter for
  437.                                | PCBoard twice as fast as prev vers. **vg**
  438.                                | Brought to you by MÄC's Place
  439. CALLKILL.ZIP    11000  01-01-89  Deletes caller log or any file when it
  440.                                | gets to big
  441. MACORG31.ZIP    75606  01-24-93  ORIGIN DOOR V3.1 for PCBoard 14.x 
  442.                                | File history tracing.  A who UL/DL that
  443.                                | file Door, faster than all existing doors
  444.                                | of similar type. Now scans 1 or 2 files !
  445.                                | Full screen help, 4% faster, files report.
  446.                                | New presentation layout, easy to install. 
  447.                                | Nothing is faster.  FreeWare from MÄC's 
  448.                                | Place BBS
  449. MACRM11.ZIP     22357  01-21-93  MACRM V1.1 for PCBoard 14.x - 15.x
  450.                                | Removes files & descriptions from PCBoard
  451.                                | directory listings. Handles unlimited 
  452.                                | number of files and dirs. Runs from 
  453.                                | constructed lists of files and dir 
  454.                                | locations.  Very fast and safe. Saves tons
  455.                                | of time when processing large amount of
  456.                                | data.  FREEWARE from MÄC's Place
  457. EZCOMP20.ZIP    99098  01-24-93  EZComp Version 2.0
  458.                                | Unix compatible compress/uncompress
  459.                                | for DOS. Extreamly Fast, true 32bit,
  460.                                | runs in 386 protected mode, (386+
  461.                                | required), full 12 - 16 bit support. 
  462.                                | Uses extended/expanded/Xms/Disk for
  463.                                | extra mem if needed. Supports older
  464.                                | unix compress, stdin etc..Rel:7/12/92
  465.                                | FreeWare from MÄC's Place BBS.
  466. MACSEC11.ZIP    79465  01-24-93  MAC SEC V1.1 for PCBoard 14.x is an ON-LINE
  467.                                | Security Upgrade Door for your users. Lets
  468.                                | your users upgrade themselves, without
  469.                                | waiting for an event to occur.  Protect up 
  470.                                | to 50 levels, File or Byte ratio, allow
  471.                                | 50 levels to be altered.  Very fast and
  472.                                | safe.  A MAC's Place BBS release. 
  473.                                | BUG FIX, now reads correct .cfg FreeWare..
  474. MACUP1.ZIP       6800  01-24-93  MACUP V1.0 PCBoard Local File Uploader
  475.                                | Allows local uploads, handles wildcards,
  476.                                | appends any dir file as well as moves
  477.                                | actual file to proper directory. Handles
  478.                                | multiple description lines also.  -VG-
  479.                                | Another Freeware program from MAC's Place
  480.                                | BBS
  481. KEEPCALL.ZIP    11000  01-01-89  Keeps PCBoards Caller logs a a user defined 
  482.                                | Size.  Designed to run in an event, you tell
  483.                                | it what size you want and it will trim your
  484.                                | callers log to the appropriate size.  
  485.                                | Maintains 64 column integrity
  486.  
  487.  
  488.  
  489.